.. _cmlStIxReadMotionState:

cmlStIxReadMotionState 
================================
--------------------------------


SYNOPSYS
`````````````
.. code-block:: none

    VT_I4 cmlStIxReadMotionState ([in] VT_I4 BoardId, [in] VT_I4 MapIndex, [out] VT_PI4 MotStates)                   

DESCRIPTION
`````````````  

- 이 함수는 보간  이송시 보간 모드에 따른 보간 이송의 속도 상태를 반환합니다.   

\

- 이 함수의 사용과 호출에 있어, 제공된 ㈜커미조아의 함수 헤더 Visual Basic 에서는 함수의
  첨두어 cml 가 붙지 않습니다.


PARAMETER
`````````````

▶ BoardId: 사용자가 설정한 디바이스(보드) ID. 
 
▶ MapIndex: 맵번호(Map index), 이 맵번호를 사용하기전에 먼저 cmlIxMapAxes() 함수를 
통하여 해당 맵번호에 유효한 축들이 맵핑되어 있어야 합니다. 
 
▶ MotStates : 보간 모드에 따른 해당 맵의 현재 속도 상태를 확인할 수 있습니다. 

 직선 보간 :  마스터 축의 속도 상태를 반환합니다. 
 
 원호보간 :  벡터 속도에 대한 속도 상태를 반환합니다. 
 
 헬리컬 보간 : Z축 방향의 속도 상태를 반환합니다. 
 
 속도 상태값은 아래와 같습니다.

  .. csv-table::
   :widths: 10 80
   :header-rows: 1
   :stub-columns: 0

   Value, Meaning
   0 또는 cmlMST_STOP, 정지상태 
   1 또는 cmlMST_IN_ACC, 가속 상태 
   2 또는 cmlMST_IN_WORKSPD, 정속 상태 
   3 또는 cmlMST_IN_DEC, 감속 상태 
   4 또는 cmlMST_IN_INISPD, 초기 속도 상태 
   5 또는 cmlMST_IN_WAIT, 대기 상태 

RETURN VALUE
`````````````

+------------+-----------+
|    Value   | Meaning   |
+============+===========+
|    음수    | 수행 실패 |
+------------+-----------+
| ERR_NONE   | 수행 성공 |
+------------+-----------+